Menus

File

Edit

Options

Sequence

Modify

Object

Animation

Functions

Drawing Tools

Choose Colour

Edit Window

Film Strip

The Additional Program RUNTAKE

Information About Take ONE


Registeing and further information
Registering and further information

Take ONE is a graphics program with which you can edit bitmaps in a simple, but powerful, environment and to create simple or complex animations.

Through the numerous possibilities of creating animation you can comfortably and simply make your own cartoons, slide shows, electronic invitation and greetings cards.

The basic editable elements are the bitmaps, which can be either created in Take ONE or imported from other programs. Through the use of the additional program RUNTAKE it is possible to chain animations together one after another and to directly install them as icons into Program Manager from Windows.

If you like this Shareware version and use Take ONE on a regular basis, you should register it, failing to do so is an infringement on Copyright. You will then receive the licensed full version together with a detailed printed manual. The full version contains a further features enabling even easier creation of animations and for example to use the animations as screen savers or desktop animations. Further you will have the right to distribute your own animations together with the runtime module RUNTAKE to friends and colleagues or even to sell them commercially.

You can print out an order form by selecting the menu item INFO -> REGISTRATION. If you do not have access to a printer simply send a letter, detailing your desired disk format (3.5 or 5.25 inch), the method of payment and of course your address. Please send orders to the following address:

Pearl America Inc.

4128½ California Ave. SW

Seattle, WA 98116

Tel.:	+1 206-938-0336

Fax:	+1 206-938-0338

CIS:	71154,505

Registration fee is $40 plus $5 shipping and handling payable by check or money order.

WA state residents please add 8.2% sales tax!

To order from the UK send your cheque or postal order for £29 to:

David Westcott

13, Chichester Gardens

Ilford, Essex

IG1 3NB

ENGLAND

If you have got any technical questions, or if you are a programmer who wants to use animations in his own programs write to:

Rainer Döbele

Stephansfelder Str. 42

78532 Tuttlingen

Germany

CIS: 100045,2007

I would be very pleased to receive examples of animations which you have created, with the possibility of them being included as example animation in a future update of Take ONE, of course you will be duly rewarded.

Version 1 of Take ONE was written in C between November 91 and July 92. Following a very positive response to the first version substantial improvements and extensions to the functionality of the program we made during a six months period from July until December 93.

The creative bunch are:

Rainer Döbele	Late night programming

Elke Mühlschegel	Love, tenderness and the original German help file

Matt Bond (Bondage)	1080 drinking and the English help file

David Westcott	English manual and distribution of the English version

Mike Barwanietz	The most dependable beta tester and the author of the following example animations:

- Aeroplane

- Transparency

- Derby Day

- Formula 1

- Radio

Freddy Wickli	the idea and drawing of the Flowers animation


Drawing Tools

Freehand drawing

Line

Rectangle

Circle

Polygon

Flood Fill

Spray can

Text

Highlight

Zoom Factor


Color Choice in the Palette Window
Colour Choice

The actual drawing colour and fill colour are selected in the colour palette window. The chosen colour will then be displayed in the uppermost portion of the palette window, the fill colour being marked by a paint pot icon over the selected colour in the palette. A fill colour can only be selected when the menu item Gradated line (under Options) is checked.

The number of available colours is dependant on both the installed display driver and from the picture format. The picture format can be changed under the menu item SEQUENCE Change Format. Loading and Pasting of pictures with 256 colours will normally use the Standard colour palette.

In two and 16 colour modes the colour palette window displays all the available colours. In 256 colour mode the window will at first display the 16 base colours. Each colour (except black & white) can then be replaced by any colour from the whole palette. Double clicking on the colour in the palette window which you wish to exchange will be followed by a dialog window from where the replacement colour can be chosen. Choosing a colour and the pressing the OK button will cause the selected colour to be exchanged (See Colour).

It is recommended to set dark colours on the left and light colours on the right hand side of the palette window.

The item Palette colour in the Options menu presents a selection of colours from the whole palette; 16 base colours, 16 gray colours and variations on particular colours, which can be selected.


Standard Color Palette
Standard Colour Palette

The default behaviour of Take ONE in 256 colour mode when loading bitmaps is to use the standard palette. The colours in the standard palette are distributed as in the colour spectrum.

Some frames (and thus frame sequences) use a specialised colour palette with out of the ordinary colours: Clearly loading such a frame or pasting a frame from the clipboard will cause it to appear strangely coloured. It is however possible to force Take ONE to use the palette of the loaded or pasted picture by holding down the SHIFT key during such operations.


Edit Window

The edit window displays the selected picture at the chosen Zoom Factor.

Mouse Functions:

left mouse button:	Activates the selected Drawing Tool and uses it with the chosen colour.

After the use of the menu item EDIT Paste, it causes a border to be displayed allowing precise positioning of the pasted object.

right mouse button:	If the Polygon drawing tool is currently selected, this will cause the current polygon to automatically be closed.

With other drawing tools it causes a pixel to be set to the background colour.

SHIFT+left mouse button:	If the picture being edited is in the 256 colour format, then the chosen pixels colour will be set in the palette window in place of the currently selected colour (except black and white), but only if the colour is not already present in the palette window.

The mouse pointer can also be positioned by means of using the arrow keys.

When editing square frames or frames that are taller than wide, the edit window and film reel are positioned beside each other. By using the separator handle, which is to the right of the edit window, it is possible to alter the proportion of each window which can be seen. Simply position the mouse pointer on the handle and drag to the left or right as desired. With pictures which are wider than tall the edit window is above the film reel window. In this case the separator handle can be dragged up or down to proportion the windows.

The relative positions of the windows can be set manually with the menu item Film Position under the Options menu, or simply by pressing the hot key F6 for Next to each other, or F7 for the film reel to be below the edit window.

The status line displays the following information:

1.	The number of the actual frame

2.	The modified status of the frame. This field is left empty when the actual frame has not been altered since being loaded, or last saved, when it has been modified then the contents of the filed is an asterix "*"

3.	The co-ordinates of the cursor in the edit window

4. 	Additional information about a selected menu item, drawing tool, or then name of objects or actual frames


Film Reel

The film reel contains all the frames that are part of a particular sequence. The frame currently selected and being edited in the edit window is displayed with a green border around it. Choice of which picture to edit in the Edit window is by clicking on the required picture in the film reel with the left mouse button. Using the right mouse button in the same operation causes the part of the picture which was clicked in the film reel to be visible in the edit window. This is especially useful if the frames are too large for the edit window to display them completely.


RUNTAKE Module
RUNTAKE

The module RUNTAKE is an additional program in Take ONE with which animations can be distributed. For this reason it is important to first set the options in the Additional Options dialog window which is called by the menu item of the same name in the Animation menu.

The menu item Install from the File menu will install an icon into a desired group of Program Manager enabling the current animation to be played (using RUNTAKE) with a double click on the created icon.

In order to copy an animation to a diskette use the follow method:

1.	Copy RUNTAKE.EXE from the Take ONE directory onto the diskette

2.	Copy the primary animation files (Those which will be started first) onto the diskette

3.	Copy all other files, Background pictures, Sound files and Following sequences, which are required into the same directory as RUNTAKE on the diskette

With the menu item Run from the File menu of Program Manager it is possible to play the animation. To install the animation in a program group, choose the New menu item from the File menu and then choose the "New program" option from the dialog window. In the following dialog window you must type the full path to RUNTAKE followed by a space and the full path to the animation file. The RUNTAKE-Icon will be installed in the current Program group and double clicking on it will play the animation.


File Menu

New

Open...

Add Frame...

Save Current Frame...

Save Sequence...

Open Animation...

Save Animation...

Install...

Quit


Edit Menu

Undo

Cut

Copy

Paste

Cancel Selection

Select  all Frames

Clear Frame

Replace Frame with...


Options Menu

Ellipse Centre

Gradated Line

Fill Pattern

Edit Palette

Select Palette

Film Position

Show Paste Area

Show Grid


Sequence Menu

Insert Frame

Copy Frame and Insert

Delete Frame

Change Format

Transparent Colour...

Swap Frame with...

Move Frame To...


Modify Menu

Scroll

Flip Horizontal

Flip Vertical

Rotate Clockwise 90°

Rotate Anticlockwise 90°

Enlarge / Shrink

Replace Colour with...

Actions Affect Selection


Object Menu

Select Object

New Object

Move / Delete Object

Free System Resources


Animation Menu

Window Parameters

Regions

Select Film Options

Define Animation

Offsets

Additional Options

Run...


Zoom Factor of the Edit Window
Zoom Factor  x2, x4, x8

These buttons allow magnification of the image being edited. There are three zoom modes available:

Original Size

Double Magnification

Four Times Magnification

Eight Times Magnification

By default when using four or eight times magnification a Grid will be displayed over the frame being edited. It is possible to toggle this option on and off with the menu item Show Grid in the Options menu.


Highlighting an area
Highlight

Highlights a part of a frame. The highlighted part of the frame will remain highlighted even when the frame is scrolled, the zoom factor is changed or another frame is selected from the film reel..

The highlighted area can be copied, cut out, changed and pasted. The cut action clears the highlighted area and the copy action will leave the frame unchanged. Both actions will put a copy of the highlighted area into the clipboard.

Clicking on an empty area of the program window will cause the highlight frame to be removed from the edit window.

In order to highlight an area of a frame which is bigger than the edit window you must first click on the start point, then, with the left mouse button still depressed, move the cursor out of the edit window. The button can now be released and the scroll bars used to bring the desired end point into the edit window. Finally depress the left mouse button again, reenter the window and release the button at the desired end point.


New Frame
File New

Creates a new frame with the entered name and format (size & colour depth).

If an image is in the clipboard then size will default to the size of this image, otherwise it will be 100x100 Pixels.

The frame should keep the place holder %d. However the name can be redefined in the Offsets menu item from the ANIMATION menu.

The frame can be saved by using FILE Save Current Frame or FILE Save Sequence.


Frame or Frame Sequence Open
File Open

This function opens a bitmap file. It is possible to open the following formats:

BMP: 	the standard Windows format for bitmap images

BMX: 	Take ONEs own format whereby several pictures with the same format (size and colour depth) are saved. By default BMX frames will be compressed.

If a file is to be opened that does not use the standard palette its possible to force Take ONE to load the palette saved with the picture by holding down the SHIFT key whilst the OK button in the File Open dialog box is pressed


Inserting a Frame or Frame Sequence
Add Frame

This function inserts a frame or sequence of frames into the current film reel.

The frame(s) will be inserted after the current contents of the film reel. A frame can be repositioned with SEQUENCE Swap frame with... or SEQUENCE Move frame to.....


Save Current Frame

This function saves the current frame (identified by a surrounding green frame) in the BMP format.


Save Sequence

This function saves all the frames contained in the film reel, even when there is only a single frame. This file will be compressed and saved in Take ONEs BMX format.

WARNING:	This function does not save the animation definition!. This task must be separately performed with Save Animation.


Opening an Animation
Open Animation

This function loads an animation definition and all its dependant files (frames etc.). The animation data can be defined in the Animations menu. When changes are made the animation data should be resaved by using the Save Animation item from the File menu.


Save Animation

This function will save an animation definition with its dependant data. The animation data can be defined in the Animations menu.


Install

This function will install an animation as an icon into a desired group of Program Manager. First select the program group into which you wish to place the icon and then click the Install button

The animation can be directly started from the Program Manager by double clicking on the newly installed icon.


Exiting the Program
Quit

Choose this menu item to leave Take ONE.

If changes to the frames or animation definition have been made then you will be prompted whether to save or discard the changes. The default is to save changes, however this can be overridden by toggling the status of the appropriate check box with a mouse click.


Undo Last Drawing Action
Undo

This function undoes the last drawing action performed in the edit window, as long as the current frame has not been changed or the animation started in the mean time.


Cutting Out a Highlighted Area and Copying to the Clipboard
Cut

This function cuts out a highlighted area and puts it into the clipboard. From there the cutout can be pasted into a frame by using EDIT Paste or into another application by using its paste function.

In order to move a highlighted area, hold the SHIFT key down and then drag (with the left mouse button held down) the cutout area to another place.

With both actions the highlighted area will be deleted.


Copying a Highlighted Area to the Clipboard
Copy

This function copies a highlighted area and puts the copy in the clipboard. From there the cutout can be pasted into a frame by using EDIT Paste or into another application by using its paste function.

In order to move a highlighted area, hold the CTRL key down and then drag (with the left mouse button held down) the cutout area to another place.

With both actions the highlighted area will NOT be deleted.


Pasting an Image from the Clipboard
Paste

This function pastes the image in the Clipboard into the current frame, or into each of the selected frames if more than one is selected in the film reel.

To position the image in the current frame click on the desired insertion position with the left mouse button. If you do not release the button is possible to drag, and thus more finely position, the cutout image to another area of the frame. In addition it is possible to see the actual image or just a border marking where it will be inserted by toggling the OPTIONS Show Paste Area menu items check mark.

The chosen transparent colour (in SEQUENCE Transparent Colour) will also be transparent as the image is pasted and repositioned.

When using images from the clipboard which use an own palette rather than the standard colour palette Take ONE can be forced to use the pasted images palette by holding the SHIFT key down while the left mouse button is released.


Clearing a Frame or a Selected Area
Clear Frame / Clear Selection

This function clears the contents of the frame currently being edited or just the highlighted cut out area if there is one.


Replace Frame with...

This function enables replacement of the currently edited frame with a saved Bitmap file. The format and the frame name will remain unchanged.


Ellipse Center, Setting
Ellipse Centre

This function provides the option to set the centre of ellipse to be either the centre of the chosen pixel (Centre of Grid Square) or on the intersection of the grid lines in the top left corner of the chosen pixel (Corner of Grid Square).


Gradated Line, Switching On / Off
Gradated Line

When the Gradated Line option is checked under the OPTIONS menu, a second colour can be chosen in the palette window. It is possible to change the selected colour (identified by a Paint Can icon) by clicking on the desired colour in the palette window with the right mouse button.

If subsequently a drawing function is used then the line will be drawn using a graduated line whose colours range between the two selected colours (the current colour and the colour identified by the Paint Can).

NOTE:	The effect of the graduated line is affected by the Pen Width (1 to 8 pixels). As the size of the pen increases the gradation will become more visible. All drawing tools will be affected by this option.


Editing the Fill Pattern
Fill Pattern

With this function you can define your own fill pattern. There is an 8x8 pixel pattern editor window with two colours (default setting: black and white) at your disposal. Through clicks with the mouse button the pattern can be defined, whereby upon use black pixels will be set to the current colour and white pixels set to the colour indicated by the Paint Can. In the small window on the right hand side the fill pattern can be viewed in its true size.

The left mouse button sets or deletes pixels and the right mouse button deletes the whole pattern.

If the option Save is checked, then the changed fill patterns will be saved so that they are available even after Take ONE is quitted.

If the pattern edit dialog box is closed with the OK button then the edited pattern will be recorded and available for selection by clicking on the pattern button [image].

The is possible to have no filling, solid filling or 1 of 12 two coloured fill patterns. The actual pattern can be selected by clicking on the [image] button.


Editing the Color Palette
Edit Palette

The standard 256 colour palette of Take ONE can be edited. There are in total 16.7 million possible colour definitions. The colours are defined by the combination of three values (set with the scroll bars), one for each of Red, Green and Blue intensities. All colours, except for the 16 base colours, can be altered. The colour palette will be saved along with frame files to which it belongs.


Exchanging the Color in the Palette Window
Exchange Colour

Double clicking on a colour in the colour palette brings up a dialog box. From here the desired colour can be selected (clicking on a colour with the left mouse button selects a new colour, identified by a thin dotted frame) and clicking the OK button will place that colour in the colour palette.

NOTE: Black and white colours cannot be exchanged.


Colors of the Palette Window
Select Palette

NOTE: This function is only available when editing 256 colour frames.

With this function it is defined which 16 colours (from the 256 possible) will be displayed in the Palette Window. There are 5 predefined choices available can be set to one of five following predefined palettes:

Standard

Red Based

Green Based

Blue Based

Monochrome

It is also possible to change a colour in the palette window for any of the 256 available by double clicking on the colour you wish to exchange and then choosing another from the resulting dialog box.


Positioning the Film Reel and Edit Window
Film Position

With this function the positioning of the film reel relative to that of the edit window can be selected. There are two possible configurations:

To the Right:	The film reel will be placed to the right of the edit window. The separator handle will be to the right of the edit window and can be moved to the left or right to adjust the proportions of each window that can be seen.

Below:	The film reel will be placed below the edit window. The separator handle will be below the edit window and can be moved up and down.

The default positioning of the windows is dependant on the shape of the frames. When editing square pictures or pictures that are taller than wide, the edit window and film reel are positioned beside each other. With pictures which are wider than tall the edit window is above the film reel window.

The relative positions of the windows can be set manually with the menu item Film Position under the Options menu, or simply by pressing the hot key F6 for Next to each other, or F7 for the film reel to be below the edit window.


Showing the Paste Area
Show Paste Area

With this option checked the Pasted image from the clipboard will be visible. Otherwise just a border marking the paste area will be displayed.

This option, when checked, slows down the pasting process thus when pasting large images it is advisable to uncheck it.

This option is also relevant when a cutout is repositioned with the SHIFT or CTRL key pressed.


Grid, Switching On / Off
Show Grid

The checking / unchecking of this option toggles the default action of Take ONE of displaying a grid over frames in the edit window. By default when using four or eight times magnification a Grid will be displayed over the frame being edited. It is possible to toggle this option on and off with the menu item Show Grid in the Options menu.

This function enables or disables the displaying of a grid (marking pixel boundaries in 4 or 8 times zoom mode) on the edit window and thus making editing simpler. The option Show Grid is active when it is checked in the OPTIONS menu.


Inserting an Empty Frame
Insert Frame

This function inserts a empty frame into the film reel just after the current frame in the sequence.

If the frame name of the current frame contains a Place Holder, then the new frame will be named after the current frame. Otherwise the frame will be named FRAME%D.BMP.


Inserting a Copy of the Current Frame into the Film Reel
Insert and Copy

This function inserts a copy of the current frame into the film reel just after the current frame in the sequence.

If the frame name of the current frame contains a Place Holder, then the new frame will be named after the current frame. Otherwise the frame will be named FRAME%D.BMP.


Place Holder
The Place Holder  "%d"

If a frame name contains a place holder then it will be replaced when saving in the following manner.

Example: 	Name of the first frame : 	FRAME%D.BMP

will be saved as :	FRAME0.BMP

Name of the second frame : 	FRAME%D.BMP

will be saved as :	FRAME1.BMP

The frame names can be specified in the Offsets item of the ANIMATION menu and will be saved in the Sequence file.


Deleting the Current Frame
Delete Frame

This function deletes the current frame.


Changing the Frame Format
Change Format

With this function the format (size and number of colours) of a frame can be changed.

In order to use 256 colours the number of colours must be set to 256 here, however this is only possible with a suitable video driver installed.

If Adapt to Size is active, then the frame contents will be scaled to fit the new size.


Setting the Transparent Color
Transparent Colour

This function sets the transparent colour for all the frames in the sequence. The pixels which are drawn in this colour will appear transparent in the final animation.

The displayed dialog box allows choice of either no transparent colour (None) or one of the 16 base colours. After pressing the OK button the new transparent colour will be set.

If the colour black or white is chosen as the transparent colour then the option Build Mask at Runtime will be activated. This causes the mask (which is required to display transparency) to be built at runtime. This brings the advantage of requiring less system resources, however will also be slower and thus is only recommended for use when the frames are small in size.


Exchanging Frames on the Film Reel
Exchange with...

With this function the position of two frames in the film reel sequence can be exchanged.

After selection of the menu item you must also click (left mouse button) on the frame in the film reel with which the current frame should be exchanged.

See Also: Move Frame To...


Moving the Current Frame to Another Position
Move Frame To...

This function move the current frame to another place in the film reel sequence.

After selection of the menu item you must also click (left mouse button) on a frame in the film reel to determine where the current frame should move to.

See Also: Exchange with...


Scroll

This function scrolls the marked cut out area one pixel up, down, left or right. The contents of the line which becomes free will not  be deleted.

If the cut out area is to be moved than once it is much easier to use the keyboard combination of holding down CTRL and then pressing the appropriate cursor key.


Flipping a Cutout Horizontally
Flip Horizontally

This function flips the cut out area horizontally.


Flipping a Cutout Vertically
Flip Vertically

This function flips the cut out area vertically.


Rotating a Cutout 90° Clockwise
Rotate Clockwise 90°

This function rotates the cut out area 90° clockwise.

If the cut out area is not square then a warning box is displayed: Rotate Anyway?. If Yes is selected then the largest square from the top left corner of the cut out area will be rotated.


Rotating a Cutout 90° Anticlockwise
Rotate Anticlockwise 90°

This function rotates the cut out area 90° anticlockwise.

If the cut out area is not square then a warning box is displayed: Rotate Anyway?. If Yes is selected then the largest square from the top left corner of the cut out area will be rotated.


Shrinking or Enlarging the Current Frame
Enlarge / Shrink

This function enables the enlarging or shrinking of a cut out area

The new size can be given as an absolute size (with x and y sizes) or as enlargement / reduction factors.

The new image can either be centred on the centre of the cut out area or x,y co-ordinates can be entered for the positioning of its top left hand corner.

If the dialog box is closed by pressing the OK button then the resizeing of the cut out area and the drawing of it into the frame at the selected position takes place.

If the dialog box is closed with the PASTE button then resized image will be placed in the clipboard and can then be further Pasted into a frame in the edit window with the menu item Paste....from the EDIT menu

Use of this function does not alter the frame format. If the sized image is positioned or sized so that the whole of it does not fit in the frame then the area outside the frame will be clipped. In order to enlarge or shrink the frame contents to fit the new frame size the option Adapt to Size in the Sequence menu must be checked.


Cutout
Cut Out Area

In order to mark a cut out area select the tool Highlight [image]  and select an area from the edit window. If no area is highlighted then the action of the items in the Modify menu apply to the whole frame.


Replacing the Current Color with Another
Replace colour with...

This function replaces all pixels of the current colour in the cut out area with another colour. In displayed dialog box the replacement colour can be chosen by clicking (with the left mouse button) on the desired colour. The replacement colour is distinguishable by the thin dashed frame surrounding it and replacement occurs on pressing of the OK button.

This function is only usable when the frame has 16 or 256 colours.


Actions Affect Selection

This menu item from the Modify menu, determines whether the actions of functions in the Modify menu affect the cut out area or the whole frame.

When a cut out area is highlighted then this menu item is automatically checked.


Definition of Objects
Object

An object can consist of a frame or a frame sequence (BMP or BMX file) and its corresponding Sequence Animation or Cycle Definition data. Thus several objects can use the same frame sequence.


Selecting Another Object to Edit
Select Object

This function allows the selection of the current Animation Object to be changed. Also in the dialog box is the possibility to change the name of the object and the frame sequence which belongs to it.


Adding a New Animation Object
New Object

With this function a new Object can be added to the animation. In the field Object Name you can type the name of the new object. If no name if given then Take ONE will allocate a name itself.

From the combo box Copy from Object you can select a previously object from which animation data is to be copied (or choose the dash "-" if no data is to be copied).

If the File option Existing File is chosen then the new object is associated with the selected Frame Sequence file in the adjacent list box. Selecting the option Open File enables association of the object with a already saved Frame Sequence file. Selecting the option New File creates a new Frame Sequence and associates it with the newly created object. This new Frame Sequence is loaded into the film reel so it can be immediately edited. NOTE: This new Frame Sequence must consequently later saved with the Save Sequence... menu item of the FILE menu.


Moving or Deleting Objects
Move / Delete Object

This function alters the sequence of Objects in the list or deletes an object from the list.

To move an object simply drag it to the desired position with the mouse. The cursor will change appropriately to double ended arrow.

Clicking the Delete button will delete the highlighted object from the object list.


Freeing Animation Resources
Free System Resources

With this function unnecessary System Resources will be freed.


Setting Animation Window Parameters
Window Parameters

This function allows the setting of Size, Background Colour and the Caption (Title) for the window in which the animation will be played (Run). These settings are a prerequisite for an animation. After closing the dialog box with the OK button further items of the Animation menu will be enabled.

The following settings are possible:

Title: The title will be used as the caption bar text in the animation window.

Window Position: The position to place the animation window on the desktop when it is started. The x,y position is relative to the top left corner of the desktop. The window will always be completely visible (in the case that the x,y co-ordinate is too big then they will be adjusted accordingly at runtime)

Window Size: The size of the animation window, without the frame or caption bar (title bar) within which it will be eventually enclosed. The option Full Screen will cause the animation to use the whole of the desktop.

Background: The background colour can be selected by clicking on the coloured button and choosing a colour from the 16 base colours in the subsequent dialog box. Additionally a background image can be used, however it must already exist as a saved BMP or BMX file. Also the position of the background image can be selected as centred (i.e. in the middle of the animation window) or by entering an x,y co-ordinate giving the position of the top left hand corner of the image relative to the top left hand corner of the animation window.

Window (Style) Options: Here parameters determine how the window will look.

Dialog Border:	A thick frame as with dialog boxes.

Standard Border:	A thin black frame.

Title Bar:	Displays a title bar above the animation, and gives the further possibilities of moving the window (by dragging the title bar), and displaying of System Menu and Minimize buttons.

System Menu:	In Take ONE the system menu is always available, however when using RUNTAKE the menu is only available when this option is checked.

Minimize Button:	With the display of a minimize button it is possible to minimize the animation to an icon on the desktop.

Always on Top:	If this option is enabled then the animation will always be in front of all other windows, even when it is not the active window.

Co-ordinates: How to interpretate the co-ordinates which are entered in the Cycle Definition

Centre Window Co-ordinates:	If this option is active then all entered co-ordinates are relative to the middle of the animation window (otherwise relative to the top left hand corner of the animation window).

Centre Frame Co-ordinates:	If this option is active then the co-ordinates are relative to the middle of the frame (otherwise relative to the top left hand corner of the frame).

You can change theses two settings and all dependant values will be adjusted automatically.

Use Timer: If this option is enabled then hardware timers will be used to control updating of the animation, otherwise the multi-tasking facility of Windows will generate the timer. Use of the hardware timer ensures that the animation will play at the same speed on any system, however disabling this option allows smoother and faster animations (dependant on your hardware).


Defining Foreground Regions
Regions

With this function you can define areas of the background image which will appear in the foreground of the animation, thus the objects appear to pass behind these areas.

In the dialog box the regions are defined by choosing the [image] -button and then highlighting an area with the left mouse button depressed.

Regions can be then marked (singularly or as a group) and then moved by use of the [image] -button and then dragging of the selected area.

The [image] -button deletes the currently selected region(s).


Defining Sequence Animations
Sequence Animation

This function produces simple animations. The frames are sequenced in the same order as they are in the film reel. After selection modification of the following selections are possible:

Sequence Delay

This scroll bar sets the delay with which the frames of the film reel cycle (animate). The speed increases with each movement of the scroller to the left i.e. the frames animate more quickly.

Motion Delay

This scroll bar sets the speed at which an object moves, i.e. how often the Motion Step will be added to the objects current position. The speed increases with each movement of the scroller to the left.

Frame Cycle

You can set the action for determining the next frame when the all frames have been displayed once. There are two possibilities (Repeat or Reverse) and in addition there are three other options to set:

Repeat: After the last frame the cycle starts over again from the first frame of the film reel. i.e. Frame 1-2-3-4-1-2-3-4 etc.

Solid Border:	If the option Solid Border is chosen, the object changes its direction as it reaches the edge of the animation window i.e. it appears to bounce off the windows border. The cycling direction of the frames in unaffected.

Toggle cycle:	In addition the option reverse cycle can be chosen. The object will now not only bounce off the windows frame but also reverse the cycling direction of frames.

Toggle Movement:	The option Reverse Direction cannot be used in Cycle Repeat mode.

Reverse: After the last frame the cycling direction of the frames reverses i.e. Frame 1-2-3-4-3-2-1-2-3-4 etc.

Solid Border:	If the option Solid Border is chosen, the object changes its direction as it reaches the edge of the animation window i.e. it appears to bounce off the windows frame. The cycling direction of frames is unaffected.

Reverse Cycle:	The option Reverse Cycle cannot be used in Cycle Reverse mode.

Reverse Direction:	In addition another option Reverse Direction can be chosen, whereby the direction of movement if the object changes at the same time as the direction of cycling changes.

Motion

Here the motion of an object is set.

Start From:	The entered x,y values determine the position where the object will start from. The absolute position is however dependant on the settings previously entered in the Co-ordinates section of the Window Parameters dialog box.

Step:	Here the relative position change of an object from one place to the next can be entered. X-Value: The movement of an object (as a number of pixels) in the horizontal direction (negative values move left and positive to the right). Y-Value: The movement of an object (as a number of pixels) in the vertical direction (negative values move up and positive down).

Start / Finish

You can set here when and / or how an animation will be ended.

Infinite:	The animation can only be ended when by double clicking on the System Menu box (left upper corner of the animation windows title bar) and the item Close is chosen.

Finish after ... Cycles:	The entered number will determine how often the animation cycle should be repeated, thereafter the animation will end.

The option Disable at Start means that the object is initially not visible and can only be started by another object. For the latter a Cycle Definition must exist for another object and in addition one of the positions of the cycle must be set to start the Disabled object by clicking on its name in the Start Objects listbox.


Definition of an Animation Cycle
Define Cycle

With this function all types of animations can be defined. In the dialog window Define Cycle there are the following components:

Menu List The menu list has six items, where general settings are defined (Co-ordinates, Motion)

Selection Reel: This film reel contains each the frames from a sequence.

Cycle Reel: The sequence (Position) of frames in this reel is the same as they will be displayed in the animation. The frame number in the film reel is however not necessarily the same as its position number in the cycle reel. The current position on the cycle reel is determined by a green border surrounding the frame. See Altering the Cycle Definition.

Positions Window: Contains the x,y co-ordinates which belong to each frame and the name of the sound file to play.

Branch if: By stipulating  a certain condition the animation can be caused to branch to a different position in the cycle when this stated condition is fulfilled. There are 3 types of conditions: a counter condition, mouse conditions and object location conditions.

Extras: There are 3 possibilities: First the cycle can be paused until restarted by another object. Second the animation can be ended or third one or more other objects can be triggered to be started or restarted (if paused).


Altering the Cycle Definition

The Cycle window has the following components:

- Menu List

- Film reel

- Positions Window

- Branch if...

- Extras

- Cycle reel

The film reel contains all the frames from a BMX file. With these frames the cycle reel will be filled:

The current frame in the film reel (recognised by the surrounding green border) will be added to the end of the cycle reel.

The current frame in the cycle reel (recognised by the surrounding green border) will be replaced by the current frame in the film reel (also with a green frame).

The current frame from the film reel is inserted into the current position on the cycle reel, and thus become the current frame on the cycle reel.

The current frame in the cycle reel will be deleted.

This ends editing the cycle definition (however the data must be later saved to disk).

Using the three boxes co-ordinates for each frame of the cycle can be entered, branching conditions set, other objects started and delays be defined.


Menu List

Object: Lists all the objects belonging to the animation.

Co-ordinates

Change X Value / Change Y Value:

In the displayed dialog box there is the possibility to quickly change the x and y values for a group of frames in the film reel. The value can be changed relatively or absolutely (Alter by, Set to) and has the option whether to change just values which are absolutely defined, relatively defined or all values regardless of their nature. In addition it can be specified on which frames these changes are to be performed. The start frame can be specified as the first frame in the film reel (Beginning), the Current Position or by typing in the number of a frame.  The last frame to include (to Position) can be set to the very last frame (end), typed as a number of frames to change (Count) or given as a particular frame number (Position).

Change Delay:

The delays associated with frames can be similarly changed as with the X and Y values.

Conditions

Left / Right Button [not] Pressed

This condition tests if the left / right mouse button is pressed (within the bounds of the animation window) at the time when this frame in the objects cycle is being displayed.

Object [not] Clicked

This condition tests if a visible part of an object is clicked on at the time when this frame in the objects cycle is being displayed.

Object Visible / Invisible

This condition tests if an object is visible or invisible in the animation window at the time when this frame in the objects cycle is being displayed.

Object [not] at Border

This condition tests if the object has reached the windows border at the time when this frame in the objects cycle is being displayed.

[Not] in Window Middle

This condition tests if the object is in the middle of the window.

Extras

Disabled at Start

The object is initially disabled.

Use Cycle Definition

Checked when the cycle definition is to be used.

Clear All

This deletes all frames entered in the cycle definition film reel.

Start

This will start the animation playing.


Position Window

Co-ordinates:

Every position of the cycle reel can be defined with x and y values. The x and y values can be defined as absolute (with the 0,0 position of an object being dependant on the settings in the Co-ordinate section of the Window Parameters dialog) or relative meaning that the given x and y values are added current x,y position of the object.

Delay:

A delay can be assigned to each position in the cycle reel i.e. how often this position will be repeated before moving on to the next position.

Fix Frame:

If the fix frame box is checked then the frame will be displayed and then remain as part of the background image.

Sound:

Click this button to select a sound to play at this position.

There are by default two sounds available in the Sound File list box.

None: No sound will be started

Switch Off: If a sound is currently being played then it will be switched off.

By clicking the Add button a new sound can be added to the Sound File listbox and then be selectable for this position. Note: Only .WAV files can be added.

The function remove is the opposite of Add and removes the highlighted sound file from the list.

Pressing the Hear button will test play the highlighted sound in the list.

The Options group determines the sound 3 possible play options:

 Low Priority:	The sound will only be played when no other sound is being played.

 Dont Wait:	When checked the sound will be played and the animation will also continue to play. When unchecked the animation will pause until the sound has been completely played.

 Repeat:	If checked then the option Dont Wait will also be automatically checked. The sound will repeat until either the animation comes to an end, the cycle reaches a position where the sound is set to Switch Off, or one where a sound which is not low priority is started.


Branch If ...

Branches (jumps) from the current position in the cycle reel to another position can be programmed in this window, when the following occurs

A Count condition and / or

a Mouse condition and / or

a Object Position condition

is defined. The position number, to where the cycle jumps to must be entered.

Count Less Than...

The internal counter of Take ONE counts how many times the animation has already reached this position and then branches to the specified position when the defined number is reached. For example if 5 was entered in the counter field then the animation would have to reach this position 5 times before branching.

Exception:	Count down field is 0: Every time the animation reaches this position it will jump.

Mouse Condition

In the menu items from the Conditions menu 1 of 6 mouse conditions can be chosen, that will be tested when the position is reached, and the cycle will only branch if the condition is fulfilled (True).

For Example:

Left / Right Button [not] Pressed

Left Button [not] Pressed:	Tests whether the left mouse button was / wasnt clicked within the bounds of the animation window.

Object [not] Clicked:	Tests whether the object was / wasnt clicked on.

To activate the condition testing, the radio button next to the chosen mouse condition must also be checked.

Object Conditions

In the menu items from the Conditions menu 1 of 6 object conditions can also be chosen, that will be tested when the position is reached, and the cycle will only branch if the condition is fulfilled (True).

Object Visible / Invisible:	Tests if the object is currently visible / not visible in the animation window.

Object [not] at Border:	Tests if the object has reached the border of the animation window or if it is still completely within it.

Object [not] in the Window Centre:	Tests if the object is / isnt in the middle of the animation window.

To activate the condition testing, the radio button next to the chosen object condition must also be checked.


Extras Box

 Wait until Start:	If the option Wait until Start is checked, the cycle will be stopped for this object until it is started again by another.

 Finish Animation:	If the option Finish Animation is checked for a position, then when this position is reached then the animation will immediately terminate.

Objects listed in the start objects list box can be clicked on to start other objects then this position is reached.


Setting Frame Offsets
Offsets

With each frame in a film roll there is a corresponding X and Y offset. Offsets are properties of frames and thus in addition to any motion definition.

The frames file name can also be changed in this dialog box.

With the forwards (>>) and backwards (<<) buttons the next or previous frame can be selected as current one into the dialog box.

If the Set All button is clicked then the current x and y offsets and the filename will be set for all frames. The Set All button will be only be enabled when the file name contains a %d Place Holder  allowing automatic numbering of frames.


Additional Options for RUNTAKE
Additional Options

The options chosen here are to configure the additional RUNTAKE program. They play no roll in animations which are started from Take ONE.

Colour Palette:

If the option Standard Colour Palette is selected then Take ONE will use the standard palette. For animations which use non standard colour palettes this option must not be selected.

Following Animation

Load Next Sequence - Maintain Window:	Another animation will be loaded, however the settings for the animation window and the backgrounds contents will remain unchanged.

Load Next Sequence - New Window:	Another animation will be loaded and the settings for the window will be changed to those defined for the newly loaded animation.

Clicking on the File button allows selection of the following animation to be chosen from a file dialog.

Usage:

Only as a Continuation Animation:	This animation can only be started as the following animation of another animation and cannot be a primary animation itself.


Start

This function starts (plays) an animation.


Freehand Drawing

draws a single point (pixel) or a freehand line in the current colour.

With the right mouse button a single point can be drawn in the chosen transparancy colour.

There are 8 Pen Widths available by clicking on the [image] button.

If OPTIONS Gradated Line is checked, then a gradated freehand line will be draw.


Line

Draws a straight line from the position where the left mouse button was pressed to the position where the button is released. The start point of the line must be clicked on and then the mouse moved to the position where the line is to end before the button is released.

Should it be necessary to draw a line which extends outside the area of the edit window then you must first mark the start point of the line by clicking in the edit window and then, still with the left mouse button pressed, move the cursor out of the edit window. The mouse button can now be released and the window scrolled with the scroll bars (or by clicking on the film reel with the right button) to the desired end point. Finally press the left mouse button again somewhere outside the edit window and move the cursor to the desired end point before releasing the button.

This process can also be used for other drawing tools.

There are 8 Pen Widths available by clicking on the [image] button.

If OPTIONS Gradated Line is checked, then a gradated line will be draw.


Rectangle

Draws a rectangle in the current colour. It is irrelevant from which corner of the rectangle you first draw. The rectangle will be filled with the selected fill colour or Fill Pattern

There are 8 Pen Widths available by clicking on the [image] button.

If OPTIONS Gradated Line is checked, then gradated lines will be used to draw the rectangle.


Ellipse

Draws an ellipse, whereby the Ellipse Centre is selected with the left mouse button and then the cursor should be dragged to a point on the circumference. The ellipse will be filled with the fill colour or Fill Pattern. .

There are 8 Pen Widths available by clicking on the [image] button.

If OPTIONS Gradated Line is checked, then gradated lines will be used to draw the ellipse.


Polygon

Draws a polygon, the lines will only be visible in the edit window at first, and will only be drawn to the actual frame when the polygon is closed.

To close the polygon automatically between the start point and the end of the last line drawn simply click the right mouse button.

The polygon will be filled in the fill colour or Fill Pattern [image].

There are 8 Pen Widths available by clicking on the [image] button.

If OPTIONS Gradated Line is checked, then gradated lines will be drawn.


Filling
Fill

Fills an area with the current colour or a chosen Fill Pattern.


Spray Can

Sprays points in the current colour. The size of the spray area is dependant on the Pen Width. The can sprays as long as the left mouse button is held down.


Text

Writes text in the current colour at the chosen position in the frame.

After selection of the text position a dialog box is displayed in which text can be entered, and the font, font size and font styles selected. All fonts which are installed in WINDOWS are available for use.

Clicking on the OPTIONS button displays a further dialog box from where the desired text alignment and colour can be selected.

The default alignment of the text is in the upper left hand corner. Settings are available from the options dialog box for the angle at which the text will be rotated, to select a new colour and the x,y alignment.

Multiple lines of text can be entered by pressing the key combination CTRL+RETURN at the end of each line.


Highlight

Highlights a frame area, the highlighted area remains marked even when the frame is scrolled, the zoom factor is changed or when another frame is chosen.

The highlighted area can be copied, cut out, changed and pasted. The cut action clears the highlighted area and the copy action will leave the frame unchanged. Both actions will put a copy of the highlighted area into the clipboard.

The highlighting of area will be unmarked when a clear area of the program window is clicked on.

In order to highlight an area of a frame which is bigger than the edit window you must first click on the start point, then, with the left mouse button still depressed, move the cursor out of the edit window. The button can now be released and the scroll bars used to bring the desired end point into the edit window. Finally depress the left mouse button again, reenter the window and release the button at the desired end point.


Pen Width

You can select from 8 different pen widths by clicking on the [image] button and then clicking on the required pen width.

If the Gradated Line option from the OPTIONS menu is checked then a gradation of colours will be used in drawing actions. The colours used in the gradation will range between the current colour and a second colour marked by a paint can in the palette window (the paint can can be moved to another colour in the palette by clicking on the desired colour with the right mouse button).